Skip to content

Conversation

@nilason
Copy link
Contributor

@nilason nilason commented Jan 16, 2026

Major rework of documentation generation with CMake.

  • consolidates code to one file (generate_doc.cmake)
  • fixes missing and/or broken parts

It does not address man file generation of indexed files. That is a bit tricky as the list of indexed files is not predictable.

It currently uses html files to generate the documentation.

With this update, comparing with diff -qr < autotools_build>$GISBASE/docs/html <cmake_build>$GISBASE/docs/html result in similar content.

Initially posted as draft as it depends on (includes) #6878 and #6904.

@nilason nilason added this to the 8.5.0 milestone Jan 16, 2026
@github-actions github-actions bot added GUI wxGUI related vector Related to vector data processing raster Related to raster data processing temporal Related to temporal data processing Python Related code is in Python database Related to database management libraries module docs general display imagery raster3d CMake labels Jan 16, 2026
@echoix
Copy link
Member

echoix commented Jan 16, 2026

@nilason can you update/rebase after the other dependant is merged?

@nilason nilason force-pushed the g_extension_cmake_with_docs branch from 6403d0c to c252fb2 Compare January 16, 2026 16:44
@nilason nilason marked this pull request as ready for review January 16, 2026 16:48
@nilason
Copy link
Contributor Author

nilason commented Jan 16, 2026

Open for review!

Copy link
Member

@echoix echoix left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall looks good, you played with it more than anyone else.

@nilason nilason merged commit 5212228 into OSGeo:main Jan 16, 2026
28 checks passed
@nilason nilason deleted the g_extension_cmake_with_docs branch January 20, 2026 06:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CMake database Related to database management display docs general GUI wxGUI related imagery libraries module Python Related code is in Python raster Related to raster data processing raster3d temporal Related to temporal data processing vector Related to vector data processing

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants